USPS Pricing Engine SDK 


December 20, 2019 


Summary 
This is the Domestic and International Pricing Engine SDK (version 11.8.0.0) for the January 
2020 Release. The following isa list of enhancements included in this release. 


B-379955 Add Cremated Remains requirements to Price Engine - Implement 
B-383700 BNS 1334 - Jan 2020 PC Enhanced Tracking - USPS Price Calculator Changes 
B-382733 BNS 1334 - Jan 2020 PC Enhanced Tracking - Business Calculator Changes 
B-383653 BNS 1334 - Jan 2020 PC Enhanced Tracking - Library Changes 
B-383654 BNS 1334 - Jan 2020 PC Enhanced Tracking - Database Changes 
B-383655 BNS 1334 - Jan 2020 PC Enhanced Tracking -Create Client Maps 

o Exclude 18B6, 022B6, 022P6, 022R6 
B374269 BNS 1309 - Jan 2020 PC - INTL Country Changes and/or Country Name Changes 
- South Sudan 
B-384313 Price Engine Mailing Date Error Message - Implement 
B-385157 BNS 1349 - Jan 2020 PC - PRC Remand FC Prices - Updated RCalc SQLs from 
Pricing Tool 
B-390583 - BNS 1314 - Jan 2020 PC - Change Servicesto Return 2 Decimal Places Instead 
of 5 for Prices 


BNS 1314 -Jan 2020 PC - Give a SKU Get a Price 

The price engine is providing a new method to identify products using a SKU, aka Stock-Keeping 
Unit. Thisinterface allows the caller to specify a specific product or group of products usinga 
15 digitkey. This capability is available for domesticand international prices. See the USPS SKU 
User’s Guide at: https://pe.usps.com/resources/PriceChange/January%202020%20- 
%20USPS%20SKU%20User%20Guide.pdf. 


GetPriceBySKU will be the replacement for the GetMailingFees method. GetMailingFees is 
being deprecated. If you use GetMailingFees, then you need to learn howto update your 
product to use GetPriceBySKU. 


publicclass SkURequest 
{ 
public SKURequest(); 
public!IDCard IDCard { get; } 
publicstring SKU { get; set; } 
public DateTime ShippingDateTime { get; set; } 
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} 


IDCard — Not required field 


e SKU Definition 
15 Digit Max, 3 Digit Minimum 
% - Wildcard represent any character 
Each digit in the SKU corresponds to a product/service 
Ex: ICCN%%X%%%%%%%% 


BNS 1364 -Jan 2020 PC - Add Dimensional Weight to USPS Retail Ground 

USPS Retail Ground is now using dimensional weighting to all zones. USPS Retail Ground 
Parcels that exceed one cubic foot (1,728 cubic inches) are charged based on the actual weight 
or the dimensional weight, whichever is greater, in all zones (Local, 1-9). The dimensional 
weight divisor will be 166 for all zones. Oversize pricing remains for USPS Retail Ground parcels 
(for parcels that measure in combined length and girth more than 

108 inches but not more than 130 inches, use the oversized price, regardless of weight, based 
on the applicable zone.) Balloon rates have been removed. 


LOR is not impacted. 


You can determine if pricing was determined by dimensional weighting by checking the 
DimensionalWeightR key in the Attributes node as shown below: 


E- PostageServices 
=- [15] USPS Retail Ground® 
Name: USPS Retail Ground® 
GroupCode: DTXX0XX 
ID: 15 
DeliveryOptions 
MaxWeight 
MinWeight 
DimensionalRange 
ExtraPostageServices 
Attributes 
=). Attributes 
Key: Dimensional WeightR 
Value: 67 


Remove Price Engine Hosted Service Commitments functionality 
The price engine is removing its own service commitment functional. It was a backup capability used if 


SDC was not available. We will rely on SDC solely for this functionality moving forward. The price 


engine will report estimated delivery dates as rangesif SDC is not available. The following table specifies 
what will be reported for each mail service: 


Mail Service Estimated Delivery times reported when SDCis 
not available 


PM_ 1 to 3 Days 
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FCM 


D-43362 - Country Information does not show PMI when the Country is 
Canada 

This corrects a current bug in production where PMI does not show for Canada. After this 
release PMI will be available for Canada. 


Deprecated Method 
The method GetMailingFees will be deprecated and no longer updated. As stated above it is 
highly recommended current users of this call switch to GetPriceBySKU. 


Changes to the Database Structure 

New databases are created to support domesticand international logicand prices. These 
databases are named USPS_DOM_2020_01 and USPS_INTL_2020 01 respectively. There is now 
only one pricing table to represent SKUs. 


Updated version number and sign all DLLs 
All the libraries have been update to version 11.8.0.0 and re-signed. 


Updated databases 

New databases have been created for this release: USPS _DOM_2020 01 and 
USPS_INTL_2020 01 for domesticand international respectively. With SKU Pricing the pricing 
tables have been replace by a single pricing table this is SKU based. 


Updates required for 2019_06 databases 
There are two scripts that must be executed against the domesticand international 2019 06 
databases. They are contained inthe 2019 06 folders of their respective databases. 


Domestic and international require the “Add Cremented Remains.sql”. Domesticalso requires 
“B-374569.sql” to support the new Service Commitments feature. 


Impact on Existing Applications 
You will have to rebuild your applications. 


Instructions 
1. Copy the DLLs 
2. Restore the databases (SQL Server 2016 backups). The database backups are not 
included and can be downloaded separately. Note: the SQL script files have been 


includedinthe package for those that cannot restore the SQL Server 2016 backups. SQL 
Scripts should be executed inthe order shown below. 
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Contents 
Description 
Folder 


Folder 
Database 


December 20, 2019 


SQL Script 
SQL Script 
SQL Script 
SQL Script 
SQL Script 
SQL Script 
Release 2 
SQL Script 
SQL Script 
SQL Script 
Release 3 
SQL Script 
SQL Script 
SQL Script 


SQL Script 
SQL Script 
SQL Script 
SQL Script 
SQL Script 
SQL Script 
SQL Script 
SQL Script 
SQL Script 
SQL Script 
SQL Script 
SQL Script 
SQL Script 
SQL Script 
SQL Script 
SQL Script 
SQL Script 
SQL Script 
SQL Script 
SQL Script 
SQL Script 
SQL Script 
SQL Script 
SQL Script 


January 2020 Release 11.8.0.0 


Database 

Domestic 

USPS _DOM_2020_01 

BNS 1314 - SKU Pricing - Create Prices Table.sql 
BNS 1314 - SKU Pricing - Drop Price Tables.sql 

BNS 1314 - SKU Pricing - Populate Prices.sql 

BNS 1314 - SKU Pricing - Update Tables to SKUs.sq| 
BNS 1349 - Update Holidays for 2020.sq]| 

BNS 1364 - Add Dim WT To USPS Retail Ground.sq| 


B-374569.sq| 
B-374569-DropOldTables.sql| 
Update USPS Retail Ground for Oversize.sq] 


Add Cremented Remains.sq] 

B-383655 Update CacheAge.sql 
B-390583 - Change Services to Return 2 Decimal 
Places Instead of 5 for Prices.sql 

BNS 1334 - Premium Data Retention.sq] 
Cleanup SKUs.sql 
CreateClient_Call_ Tag 019R4.sq] 
CreateClient_CNS_008B3.sq] 
CreateClient_CNS_ O08R3.sql 
CreateClient_CNSB_eVS_O09B6.sq| 
CreateClient_CNSB_eVS_O09B8.sq] 
CreateClient_CNSB_eVS_OO9P6.sq] 
CreateClient_CNSB_eVS_O09P8.sq] 
CreateClient_CNSB_Meter_O09B5.sq| 
CreateClient_CNSB_Retail_Stamps_O09R4.sq| 
CreateClient_EASRv2_015B4.sql 
CreateClient_EASRv2_015P4.sq| 
CreateClient_EASRv2_015R4.sql 
CreateClient_EDDMR_028R6.sq| 
CreateClient_eVS_011B6.sql 
CreateClient_eVS_ 011B8.sql 
CreateClient_eVS_011P6.sql 
CreateClient_eVS_ 011P8.sql 
CreateClient_eVS_025B6.sq| 
CreateClient_eVS_025B8.sql 
CreateClient_eVS_025P6.sql 
CreateClient_eVS_025P8.sql 
CreateClient_MetroPost_016R4.sql 
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Folder 
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SQL Script 
SQL Script 
SQL Script 
SQL Script 
SQL Script 
SQL Script 
SQL Script 
SQL Script 
SQL Script 
SQL Script 
SQL Script 
SQL Script 
SQL Script 
SQL Script 
SQL Script 
SQL Script 
SQL Script 
SQL Script 
SQL Script 


SQL Script 
SQL Script 


SQL Script 
SQL Script 


SQL Script 
SQL Script 
SQL Script 
SQL Script 
SQL Script 
SQL Script 
SQL Script 


Database 


SQL Script 
SQL Script 
SQL Script 
SQL Script 
SQL Script 
Release 3 
SQL Script 


January 2020 Release 11.8.0.0 


CreateClient_Mobile_023C4.sql 
CreateClient_MRS_017B4.sql 
CreateClient_MRS_017R4.sq] 
CreateClient_PASS_012R4.sql 
CreateClient_PC_ Postage _007B7.sq| 
CreateClient_PFSC_018B6.sq] 
CreateClient_Pl_020B4.sq| 
CreateClient_P|_020R4.sq] 
CreateClient_PriceCalc_014C4.sq] 
CreateClient_PriceCalc_014R4.sq] 
CreateClient_PriceCalc_014X0.sq] 
CreateClient_RRAM_021R4.sql 
CreateClient_SBP_022B6.sq] 
CreateClient_SBP_022P6.sq| 
CreateClient_SBP_022R6.sq] 
CreateClient_WebTools_004B4.sql 
CreateClient_WebTools 004P4.sql 
CreateClient_WebTools_004R4.sql 

D-45501 - GetServicesWithPricing Returns 3 Postage 
Prices.sql 

D-45719 - PM Regional Rate Boxes Prices are 
Incorrect.sq| 

D-46024 - Domestic PM APO Flat Rate Box Price 
Incorrect.sq| 

D-46038 - EDDM Flats Returns 0.00 over 4 oz.sql 
D-46042 - Dom Parcel Return Svc Machinable Balloon 
& Oversized Pricing.sql 

D-46220 - Incorrect FCM Metered Letter Price.sq] 
D-46329 - Bulk Insurance Not Returning a Price.sq| 
Prices.sql 

2019 06\ Add Cremented Remains.sql 

2019 06\ B-374569.sql 

Undo D-45398.sq 

D-46374 - Comm BPM Decimal Precision.sql 
International 

USPS_INTL_2020 01 

BNS 1314 - SKU Pricing - Create Prices Table.sql 
BNS 1314 - SKU Pricing - Drop Price Tables.sql 
BNS 1314 - SKU Pricing - Populate Prices.sql 

BNS 1314 - SKU Pricing - Update Tables to SKUs.sql 
BNS-1309 - E-USPS INTL Country Changes.sq] 


Add Cremented Remains.sq] 
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SQL Script B-390583 - Change Services to Return 2 Decimal 
Places Instead of 5 for Prices.sql| 
SQL Script BNS 1309 Create South Sudan.sq| 
SQL Script D-46010 - PostCalc FCMI Postcards No Charge.sq| 
SQL Script D-46016 - Canada PMEI Comm Plus Zone 2 No 
Price.sql 
SQL Script D-46017 - IPA Parcels No Prices.sql 
SQL Script Prices.sql 
SQL Script D- 46090-Canada PMI DVD Flat Rate Box Price .sql 
SQL Script 2019 _06\ Add Cremented Remains.sql 
Folder DLL 

Rate Engine Framework RateEngine_Framework.dll 

Business Framework RateEngine_Business.dll 

Domestic Business Rate RateEngine_DomBusiness.dll 

Engine 

International Business Rate RateEngine_IntIlBusiness.dll 

Engine 

Service Delivery Extensions Service DeliveryExtensions.dll 

Customs Forms Engine CustomsFormsEngine.dll 

Folder Documentation 
Design Model Pricing Engine.pdf 
Release Notes USPS Pricing Engine SDK 11_8 O O.pdf 


Reported Defects and Change Request 
| Title Status 


BNS 1334 - Jan 2020 PC Enhanced Tracking Completed 


D-45398, D-45475 - BNS 1314 - Jan 2020 PC - Signature Confirmation price Completed 
amount 0.00 

D-45501 - BNS 1314 - Jan 2020 PC - GetServicesWithPricing Returns THREE Completed 
a O.RaWR A 


D-45719 - PM Regional Rate Boxes Prices are Incorrect.sql Completed 


D-45937 - BNS 1314 - Jan 2020 PC - Extra Service Error (Certificate of Mailing | Completed 
Bulk) 
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Incorrect 
Nonautomation Prices 


D-46038 - BNS 1314 - Jan 2020 PC - EDDM Flats Returns 0.00 over 4 oz. Completed 


D-46042 - BNS 1314 - Jan 2020 PC - Dom Parcel Return Svc Machinable Completed 
Balloon & Oversized Pricing 


D-46089 - BNS 1314 - Jan 2020 PC - Intl Insurance Not Returning Initial Price Completed 
D-46090 - BNS 1314 - Jan 2020 PC - Canada PMI DVD Flat Rate Box Price Completed 


D-46238 - BNS 1314 - Jan 2020 PC - Canada ECOMPRO PMI Zone 2 Prices Completed 


D-46243 - BNS 1314 - Jan 2020 PC - Standardize Solution for Intl Insurance Completed 
Not Returning Initial Price 


D-46329 - BNS 1314 - Jan 2020 PC - Bulk Insurance Not Returninga Price Completed 
D-46374 - BNS 1314 - Jan 2020 PC - Dom Comm BPM Decimal Precision > 2 Completed 


D-46232 - BNS 1314 - Jan 2020 PC - ECOMPRO DVD Flat Rate Box Completed 


D-46220 - BNS 1314 - Jan 2020 PC - Incorrect FCM Metered Letter Price Completed 


BNS 1334 - Jan 2020 PC Enhanced Tracking 
Two new Extra Services have been added to support Enhance Tracking. 


Description 


Scan Retention 


Scan + Signature Retention 


This 2 Extra Services work similarto variable Extra Service where the number of months will be 
specified as an Additional Input Value with the tag of “rtp”. The following table defines the valid 
values: 


(Eara Servie [Description [vme SCS 
Scan Retention 
Scan + Signature Retention 
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The following error message will be returned: 


Error | Message 
Code 


50082 | Warning - The Retention Period can only be 0.5, 1, 3, 5, 7 or 10 
Scan + Signature Retention | 50082 | Warning - The Retention Period can only be 3,5, 7 or 10 


BNS 1314 - Jan 2020 PC - Signature Confirmation price amount 0.00 
The SKUs were incorrect for flat rate products. 


BNS 1314 - Jan 2020 PC - GetServicesWithPricing Returns THREE 
PostagePrices: O, R,andR 
The SKUs have been corrected. 


BNS 1314 - Jan 2020 PC - PM Regional Rate Box A & B Prices for Incorrect Zone 
The SKUs have been corrected. 


BNS 1314 - Jan 2020 PC - Change Services to Return 2 Decimal Places Instead 
of 5 for Prices 
Code change to reduce decimal places. 


D-45398, D-45475 - BNS 1314 - Jan 2020 PC - Signature Confirmation price 
amount 0.00 
Updated the SKU. 


D-45501 - BNS 1314 - Jan 2020 PC - GetServicesWithPricing Returns THREE 
PostagePrices: O, R, and R 
Updated the SKU. 


D-45719 - BNS 1314 - Jan 2020 PC - PM Regional Rate Box A & B Prices for 
Incorrect Zone 
Updated the SKU. 


D-45935 - BNS 1314 - Jan 2020 PC - FCMI Flats Return No Charge 
Corrected SKU-based pricing logic. 


D-45937 - BNS 1314 - Jan 2020 PC - Extra Service Error 
Corrected SQL parameters in code. 


D-46010 - BNS 1314 - Jan 2020 PC - PostCalc FCMI Postcards No Charge 
Database change to the SKU for the calculator elementfrom group 2 to group 3. 
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D-46011 - BNS 1314 - Jan 2020 PC - No PMI Flat Rate Boxes for Canada 
Corrected code. This issues also effected PMI flat rate envelopes. 


D-46012 - BNS 1314 - Jan 2020 PC - 0.5 lb Returns 1 lb GXG Price 
Updated code to allow .5 as a weight break. 


D-46015 - BNS 1314 - Jan 2020 PC - PMEI.5 lb Returns 1 lb Price 
Updated code to allow .5 Ibs. 


D-46016 - BNS 1314 - Jan 2020 PC - Canada PMEI Comm Plus Zone 2 No Price 
Corrected SKU logic. 


D-46017 - BNS 1314 - Jan 2020 PC - IPA Parcels No Prices 
Updated SKU in the Calculator Elements table from 40 Ibs. to 44 Ibs. 


D-46024 - BNS 1314 - Jan 2020 PC - Domestic PM APO Flat Rate Box Price 
Incorrect 
Update SKUs in the database to the correct value. 


D-46026 - BNS 1314 - Jan 2020 PC - Dom FCM-Letters, Questionable 
Nonautomation Prices 


Addeda conditional to the first-class mail class to check if the SKU based pricing is being used. 
If it is don't add the non-machinable surcharge. 


D-46038 - BNS 1314 - Jan 2020 PC - EDDM Flats Returns 0.00 over 4 oz. 
Corrected weight limit from 16 oz. to less than 16 oz. 


D-46042 - BNS 1314 - Jan 2020 PC - Dom Parcel Return Svc Machinable 
Balloon & Oversized Pricing 
Corrected the ‘DS’ keysin the database. 


D-46089 - BNS 1314 - Jan 2020 PC - Intl Insurance Not Returning Initial Price 
Updated code to properly set the initial price when the declared value is zero. 


D-46090 - BNS 1314 - Jan 2020 PC - Canada PMI DVD Flat Rate Box Price 
Updated the SKU. 


D-46220 - BNS 1314 - Jan 2020 PC - Incorrect FCM Metered Letter Price 
Updated the SKU. 


D-46232 - BNS 1314 - Jan 2020 PC - ECOMPRO DVD Flat Rate Box 
Updated the SKU. 
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D-46238 - BNS 1314 - Jan 2020 PC - Canada ECOMPRO PMI Zone 2 Prices 
SQL to add in zone 2 SKUs. 


D-46243 - BNS 1314 - Jan 2020 PC - Standardize Solution for Intl Insurance Not 
Returning Initial Price 
Added logic to handle insurances. 


D-46329 - BNS 1314 - Jan 2020 PC - Bulk Insurance Not Returning a Price 
Updated the SKU. 


D-46374 - BNS 1314 - Jan 2020 PC - Dom Comm BPM Decimal Precision > 2 
Created SQL script to set the display format to two decimal places. 
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